home *** CD-ROM | disk | FTP | other *** search
/ Amiga Game-Power / Amiga Game-Power.iso / pd mix i / pict saver / analyrim / dbmsdocs.zoo / analyplot.doc < prev    next >
Text File  |  1992-01-05  |  4KB  |  74 lines

  1. AnalyRIM's PLOT function
  2.  
  3. AnalyRIM has a primitive designed to allow it to cooperate with a plotting
  4. program such as GnuPLOT to plot data from the spreadsheet on whatever
  5. output devices the plot program handles (which for GnuPLOT are many!).
  6. This is handled by a command PL which plots one or two ranges (depending
  7. on whether you want to plot only Y coordinates or both X and Y coordinates)
  8. and a convention to allow title and the like information to be passed.
  9.  
  10. The command added is
  11.  
  12. PL v1:v2,v3:v4;systemcommand
  13.  
  14. and the action is the following:
  15.  
  16. The first range v1:v2 must be a cell range (horizontal, vertical or
  17. page) which corresponds to the X coordinates to plot if the v3:v4
  18. argument exists, or which corresponds to the Y coordinates if
  19. not. The second range, if present, must be another legal range
  20. (in any direction). Both ranges must be one dimensional and
  21. should be the same length if both are present.
  22.    AnalyRim will produce a file named "pccplt.dat" in the default
  23. directory containing the values of the cells in the one or two
  24. ranges, either one value per line (if only v1:v2 is in the 
  25. command) or two values per line (if both exist) so that the
  26. lines each contain one point to be plotted. This is the format
  27. GnuPlot (among others) want.
  28.    In addition, the contents of the FORMULAS for accumulators X,
  29. Y, and Z will be placed in a file "titleinfo.txt" also in the default
  30. directory. These may be used to pass titles, commands to format the
  31. plot, or whatever. In the case of GnuPLOT, even a "load" command may
  32. be placed here to do fancier formatting using some other predefined
  33. file. The first 80 characters of each formula are copied without
  34. further examination.
  35.    Once these files are created (and closed), AnalyRIM executes a command
  36. which is either the "systemcommand" part of the PL command, or which
  37. defaults to the command @DK:PLTFIL.PCP on VMS, to EXECUTE DK:PLTFIL.PCP
  38. on AmigaDos, and to the command /DK/PLTFIL.PCP in Unix. The system
  39. command part can be whatever syntax is desired, but will generally be a
  40. script which will run the plot program and get it to read the data (and
  41. possibly title information) and produce a plot. The plot output and
  42. format may be controlled by the input passed to the plot program.
  43.  
  44.   The reason the X, Y, and Z accumulator formulae don't have any pre-added
  45. text is to allow this text to be placed in the accumulator.
  46.  
  47.    It is expected that for actual use, a command file to AnalytiCalc
  48. will be devised to be activated by a function key, and that this file
  49. will cause title information to be placed in the X/Y/formulae and
  50. will select the range(s) to be plotted and the style of the plot.
  51.     By moving this functionality to a separate program, AnalyRIM avoids
  52. having to duplicate work already available, yet permits plotting to
  53. be done (once some setup is done) as conveniently as if the plotting
  54. code were linked in.
  55.  
  56.    For the benefit of VMS users, GNUPLOT is included in this area already
  57. built for VMS, and a ZOO archive of the Gnuplot sources is present also
  58. which can be built for other machines. Amiga GnuPlot may be found in the
  59. [.analyrim.amiga] directory. Also a template PLTFIL.PCP is present
  60. which may be copied to DK: for VMS to give a linear plot on a Tektronix
  61. mode screen. For the title material to be useful, the X/Y/Z accumulator
  62. formulae need to contain commands like "title=mumble" and one
  63. would have to edit PLTFIL.PCP to include a command "load titleinfo.txt"
  64. to pull those commands in. You need to edit PLTFIL.PCP in any case to
  65. reflect your desired terminal type and so on. You also need to be
  66. aware that the first cell range you give is the X and the second is the
  67. Y coordinates where you give two. If you omit the X coordinates and have
  68. only one range, Gnuplot will assume X coordinates 1,2,3,...
  69.    Other plotting programs can be used as desired. The AnalytiCalc
  70. plot program, which reads saved AnalytiCalc spreadsheets, can also
  71. of course be used to plot whatever is wanted from an already-saved
  72. sheet. The PL command interface is more interactive, though, and the plotting
  73. engine more capable in some ways.
  74.